home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / enigma / earcd / editor / editor2 / hsc.lha / hsc / src_docs / about.hsc next >
Text File  |  1996-12-04  |  3KB  |  80 lines
  1. <WEBPAGE chapter="hsc - " title="Introduction"
  2.     PREV="index.html" NEXT="copy.html"
  3.     QTEXT="Welcome Boyz and Girls to the Non-Official Shit-Reduction Program"
  4.     QAUTHOR='Novi Sad, "Me, Myself, All Over Again"'>
  5.  
  6. <H2>Motivation</H2>
  7.  
  8. <P>If you read this, it's quite likely that you tried to design a
  9. html-page. And you probably found out that html is a very
  10. clumsy thing: No macros, no include files and several other
  11. features lacking.</P>
  12.  
  13. <P>And what can you do after your page is ready? View it
  14. with a browser and test-click all links? Pfuahahaha! Most
  15. browser are designed to handle as many errors as possible
  16. and display a readable page, but don't mention your errors!
  17. And link-testing is a very stupid task...</P>
  18.  
  19. <P>Of course, there are several tools around: You can use a
  20. C-preprocessor to define macros and include files, use
  21. some of the various html-validators, replace your special
  22. characters with <KBD>recode</KBD> and run a link-test-tool
  23. on your page.</P>
  24.  
  25. <P>So, after installing several Tools (and compilers and
  26. interpreters), you are ready to go... and can start five
  27. programs after a simple change to one of your pages.</P>
  28.  
  29. <P>(Note: People who use the C-Preprocessor are easy to identify 
  30. by the silly date format of <CODE>__DATE__</CODE>: who writes
  31. <CODE>Feb 23 1995</CODE> on purpose?)</P>
  32.  
  33. <H2>What it is</H2>
  34.  
  35. <P><hsc> tries to summarize the functionality of all
  36. these tools in one program: it performs a (small) syntax
  37. check, tests your (local) links, replaces special characters
  38. by their entities and provides a very html-like way to
  39. define macros.</P>
  40.  
  41. <P>It also supports several features you probably won't
  42. find in most other tools, like absolute URIs, stripping useless
  43. white-spaces and automatically setting the size-attributes
  44. for images.
  45. For complex projects, a project-file can be maintained
  46. and a dependency generator helps you keeping your Makefile
  47. up-to-date.</P>
  48.  
  49. <H2>How it works</H2>
  50.  
  51. <P><hsc> simply acts as a preprocessor: You give it an
  52. "extended" html-source (later in this document refered as
  53. "hsc-source") containig special commands, and <hsc>
  54. interprets it and produces a pure html-output as object
  55. file. This output-file can be viewed with your
  56. w3-browser.</P>
  57.  
  58. <P>Normally I write my hsc-sources using a simple text-editor,
  59. maintain them in a <FILE>Makefile</FILE> and process them
  60. with <hsc>. From my point of view, this is the recommend
  61. way of using this tool.</P>
  62.  
  63. <H2>What it isn't</H2>
  64.  
  65. Obviously, there is no fancy gui, no (pseudo-)WYSIWYG, no drag &
  66. drop - there are other programs which provide these
  67. functionalities. But a common lack of these programs usually
  68. is that they give less support for large projects and are limited
  69. in configurability.</P>
  70.  
  71. <P>If you just want to create your own personal homepage,
  72. write a short html-document with information about your
  73. three selfwritten freeware-proggies, include a picture of your cat,
  74. send greets to Sepp and Hugo or something like that,
  75. there are probably other tools which are easier to handle and
  76. will serve your needs well. But of course, I can't prevent you from
  77. using <hsc> for these tasks, too.</P>
  78.  
  79. </WEBPAGE>
  80.